home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / polf.z / polf
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ppppoooollllffff((((3333GGGG))))                                                              ppppoooollllffff((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppoooollllffff,,,, ppppoooollllffffiiii,,,, ppppoooollllffffssss,,,, ppppoooollllffff2222,,,, ppppoooollllffff2222iiii,,,, ppppoooollllffff2222ssss - draws a filled polygon
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppoooollllffff((((nnnn,,,, ppppaaaarrrrrrrraaaayyyy))))
  13.      iiiinnnntttteeeeggggeeeerrrr****4444 nnnn
  14.      rrrreeeeaaaallll ppppaaaarrrrrrrraaaayyyy((((3333,,,,nnnn))))
  15.  
  16.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppoooollllffffiiii((((nnnn,,,, ppppaaaarrrrrrrraaaayyyy))))
  17.      iiiinnnntttteeeeggggeeeerrrr****4444 nnnn
  18.      iiiinnnntttteeeeggggeeeerrrr****4444 ppppaaaarrrrrrrraaaayyyy((((3333,,,,nnnn))))
  19.  
  20.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppoooollllffffssss((((nnnn,,,, ppppaaaarrrrrrrraaaayyyy))))
  21.      iiiinnnntttteeeeggggeeeerrrr****4444 nnnn
  22.      iiiinnnntttteeeeggggeeeerrrr****2222 ppppaaaarrrrrrrraaaayyyy((((3333,,,,nnnn))))
  23.  
  24.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppoooollllffff2222((((nnnn,,,, ppppaaaarrrrrrrraaaayyyy))))
  25.      iiiinnnntttteeeeggggeeeerrrr****4444 nnnn
  26.      rrrreeeeaaaallll ppppaaaarrrrrrrraaaayyyy((((2222,,,,nnnn))))
  27.  
  28.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppoooollllffff2222iiii((((nnnn,,,, ppppaaaarrrrrrrraaaayyyy))))
  29.      iiiinnnntttteeeeggggeeeerrrr****4444 nnnn
  30.      iiiinnnntttteeeeggggeeeerrrr****4444 ppppaaaarrrrrrrraaaayyyy((((2222,,,,nnnn))))
  31.  
  32.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ppppoooollllffff2222ssss((((nnnn,,,, ppppaaaarrrrrrrraaaayyyy))))
  33.      iiiinnnntttteeeeggggeeeerrrr****4444 nnnn
  34.      iiiinnnntttteeeeggggeeeerrrr****2222 ppppaaaarrrrrrrraaaayyyy((((2222,,,,nnnn))))
  35.  
  36.      All of the above routines are functionally the same.  They differ only in
  37.      the declared type of their parameters and whether or not they assume a
  38.      two-dimensional or three-dimensional world.
  39.  
  40. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  41.      _n        expects the number of vertices in the polygon.
  42.  
  43.      _p_a_r_r_a_y   expects the array containing the vertices of the polygon.
  44.  
  45. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  46.      ppppoooollllffff fills the polygonal area bounded by the vertices specified in
  47.      _p_a_r_r_a_y.  The first and last vertices connect automatically to close a
  48.      polygon.  The vertices can be expressed as integers, shorts, or real
  49.      numbers, in 2-D or 3-D space.  2-D polygons are drawn with _z=0.  After
  50.      the polygon is filled, the current graphics position is set to the first
  51.      vertex in the array.
  52.  
  53.      Properties that affect the drawing of polygons include the current color,
  54.      writemask, fill pattern, shade model, polygon antialiasing mode, polygon
  55.      scan conversion mode, and subpixel mode.  Some polygon modes are
  56.      applicable only if old-style scan conversion is defeated.  (See note
  57.      below.)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppoooollllffff((((3333GGGG))))                                                              ppppoooollllffff((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      There can be no more than 256 vertices in a polygon. In addition, ppppoooollllffff
  75.      cannot correctly draw polygons that intersect themselves.
  76.  
  77. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.      backfa, bgnpol, concav, frontf, glcomp, poly, polymo, polysm, scrsub,
  79.      setpat, shadem, subpix
  80.  
  81. NNNNOOOOTTTTEEEE
  82.      By default ppppoooollllffff draws a polygon using the old-style scan conversion
  83.      algorithm, rather than the point sampling algorithm used by bbbbggggnnnnppppoooollll and
  84.      eeeennnnddddppppoooollll.  Point sampling is prefered over old-style scan conversion
  85.      because it has higher performance, it results in higher-quality images
  86.      when blending, logical operations, or stenciling are used, and it
  87.      supports new rendering features such as texture mapping, fog, and
  88.      antialiasing.  Call ggggllllccccoooommmmpppp((((GGGGLLLLCCCCOOOOLLLLDDDD,,,,0000)))) to enable point sampling of polygons
  89.      generated by ppppoooollllffff.
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.